Favicon

You are here: Home > API Reference > UEM > Device Audiences > Preview device audience members

Preview device audience members

Required Permission: mdm.global.deviceAudience.preview

Preview device audience members

POST
https://api.applivery.io/v1/organizations/{organizationId}/mdm/device-audiences/preview
curl -X POST "https://api.applivery.io/v1/organizations/{organizationId}/mdm/device-audiences/preview" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
  "selectors": {
    "deviceGroups": [],
    "mdmUserGroups": [],
    "emmDeviceIds": [],
    "admDeviceIds": [],
    "winDeviceIds": [],
    "aosDeviceIds": [],
    "mdmUserIds": [],
    "serialNumbers": [],
    "smartAttributes": []
  }
}'
const response = await fetch("https://api.applivery.io/v1/organizations/{organizationId}/mdm/device-audiences/preview", {
  method: "POST",
  headers: {
    Authorization: "Bearer <YOUR_API_KEY>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "selectors": {
      "deviceGroups": [],
      "mdmUserGroups": [],
      "emmDeviceIds": [],
      "admDeviceIds": [],
      "winDeviceIds": [],
      "aosDeviceIds": [],
      "mdmUserIds": [],
      "serialNumbers": [],
      "smartAttributes": []
    }
  }),
});

const data = await response.json();
import requests

response = requests.post(
    "https://api.applivery.io/v1/organizations/{organizationId}/mdm/device-audiences/preview",
    headers={"Authorization": "Bearer <YOUR_API_KEY>"},
    json={
      "selectors": {
        "deviceGroups": [],
        "mdmUserGroups": [],
        "emmDeviceIds": [],
        "admDeviceIds": [],
        "winDeviceIds": [],
        "aosDeviceIds": [],
        "mdmUserIds": [],
        "serialNumbers": [],
        "smartAttributes": []
      }
    },
)

data = response.json()

Request

Send your API key in the request header authorization
Example: Authorization: Bearer <token>

organizationId string
required
Match pattern: ^(([a-fA-F0-9]{24})|([a-zA-Z0-9\\-]{3,}))$

page string
optional
limit string
optional
platform string
optional
androidapplewindowsaosp
deviceName string
optional
serialNumber string
optional
selectorFilter object
optional
segmentId integer
optional

Body Params application/json
selectors object required
deviceGroups array [array] required
mdmUserGroups array [array] required
emmDeviceIds array [string] required
admDeviceIds array [string] required
winDeviceIds array [string] required
aosDeviceIds array [string] optional
mdmUserIds array [string] required
serialNumbers array [string] required
smartAttributes array [object] optional
id string required
Match pattern: ^[a-fA-F0-9]{24}$
operator any required
value any required
{
    "selectors": {
        "deviceGroups": [
            [
                "string"
            ]
        ],
        "mdmUserGroups": [
            [
                "string"
            ]
        ],
        "emmDeviceIds": [
            "string"
        ],
        "admDeviceIds": [
            "string"
        ],
        "winDeviceIds": [
            "string"
        ],
        "aosDeviceIds": [
            "string"
        ],
        "mdmUserIds": [
            "string"
        ],
        "serialNumbers": [
            "string"
        ],
        "smartAttributes": [
            {
                "id": "string",
                "operator": "equal",
                "value": "string"
            }
        ]
    }
}

Responses

200 Response application/json
status boolean required
data object required
emmDevices array [object] required
id string required
Match pattern: ^[a-fA-F0-9]{24}$
displayName string optional
≤ 256 characters
mdmUserId string optional
Match pattern: ^[a-fA-F0-9]{24}$
state any required
summary any required
admDevices array [object] required
id string required
Match pattern: ^[a-fA-F0-9]{24}$
displayName string optional
≤ 256 characters
mdmUserId string optional
Match pattern: ^[a-fA-F0-9]{24}$
state any required
summary any required
winDevices array [object] required
id string required
Match pattern: ^[a-fA-F0-9]{24}$
displayName string optional
≤ 256 characters
mdmUserId string optional
Match pattern: ^[a-fA-F0-9]{24}$
state any required
summary any required
aosDevices array [object] required
id string required
Match pattern: ^[a-fA-F0-9]{24}$
displayName string optional
≤ 256 characters
mdmUserId string optional
Match pattern: ^[a-fA-F0-9]{24}$
state any required
summary any required
{
    "status": true,
    "data": {
        "emmDevices": [
            {
                "id": "string",
                "displayName": "string",
                "mdmUserId": "string",
                "state": "PROVISIONING",
                "summary": "string"
            }
        ],
        "admDevices": [
            {
                "id": "string",
                "displayName": "string",
                "mdmUserId": "string",
                "state": "PROVISIONING",
                "summary": "string"
            }
        ],
        "winDevices": [
            {
                "id": "string",
                "displayName": "string",
                "mdmUserId": "string",
                "state": "PROVISIONING",
                "summary": "string"
            }
        ],
        "aosDevices": [
            {
                "id": "string",
                "displayName": "string",
                "mdmUserId": "string",
                "state": "PROVISIONING",
                "summary": "string"
            }
        ]
    }
}
401 Response application/json
status boolean optional
false
error object optional
code number optional
4004
message string optional
Invalid Token
{
    "status": false,
    "error": {
        "code": 4002,
        "message": "No auth token"
    }
}
404 Response application/json
status boolean optional
false
error object optional
code number optional
3001
message string optional
Entity not found
{
    "status": false,
    "error": {
        "code": 3001,
        "message": "Entity not found"
    }
}